home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 32 / songedit.zip / MANUAL.TXT < prev    next >
Text File  |  1988-03-09  |  11KB  |  257 lines
  1.  
  2.  
  3.  
  4. George Campbell
  5. 1472 Sixth St.
  6. Los Osos, CA  93402
  7.        
  8.          
  9. SongEdit: A Music Editor for Your PC
  10.        
  11. George Campbell
  12.  
  13.  
  14.      IBM PCs and compatible computers offer a wide variety
  15. of useful and interesting functions.  Their music-making
  16. capabilities, however, are often neglected by users.  While
  17. they do not offer the multi-voice music of some other
  18. computers, you can create very elaborate musical
  19. effects...with a little help.
  20.      "SongEdit" is based on the BASICA/GWBASIC PLAY
  21. statement, and allows you to take full advantage of the
  22. capabilities built into those languages.
  23.      Anyone who has written music with BASICA/GWBASIC
  24. recognizes the difficulties of working with the
  25. interpreter's editor. Too often, attempts at composition are
  26. abandoned because of the awkward user interface.
  27.     "SongEdit", compiled with Microsoft QuickBASIC, solves
  28. those problems, making the process of writing music a
  29. pleasure.  Using "SongEdit", you can create new
  30. compositions, transcribe existing music, and edit or change
  31. your musical creations.  Its interactive editor allows you
  32. to play your tunes, returning to the editor for changes.
  33. You can save tunes, either as .TUN files, meant to work with
  34. "SongEdit", or as BASIC programs. Using "SongEdit," you can
  35. link up to six tunes together, to create large compositions.
  36.    Other features of "SongEdit" include a feature which
  37. allows your PC to compose its own music.  Help screens are
  38. always available to assist you, and a handy directory
  39. feature lets you keep track of your .TUN files.
  40. INSTALLING SONGEDIT
  41.      To install "SongEdit" on a floppy disk, format a disk
  42. with the /S switch to create a working disk.  Copy the
  43. "SongEdit" files from the disk in the magazine to your new
  44. disk.  The files you need are: SONGEDIT.EXE plus the files
  45. with a .TUN extension.  The .TUN files are samples.
  46.      If you want to run "SongEdit" from a hard disk, create
  47. directory called SONGEDIT on your hard disk.  Copy the
  48. "SongEdit" files to this directory and you are ready to run
  49. the program.
  50.      Using either type of disk, the .TUN and .BAS song files
  51. you create will be saved to the disk or directory holding
  52. the SONGEDIT.EXE program.
  53. RUNNING SONGEDIT
  54.      To start the program, enter the command: SONGEDIT.  The
  55. program will display an opening screen, then move directly
  56. to the editing mode.  The top part of the screen always
  57. displays information on the program's features.  The bottom
  58. line of your screen keeps you informed about the current
  59. status of the program.
  60.     The remainder of the screen is the tune entry and
  61. editing area.  You may enter characters into the music
  62. string, or use the cursor keys to position the cursor
  63. anywhere within the editing area.  "SongEdit"'s editing mode
  64. rejects invalid characters. Change a character by
  65. positioning the cursor, then overtype.
  66.      The backspace key removes one character to the left of
  67. the cursor. Use the <Del> key to remove the character at the
  68. cursor position.  To insert a character in the middle of the
  69. string, position the cursor, then press the <Ins> key.  Any
  70. character you type will appear to the left of the cursor.
  71.      For information on the structure and syntax of
  72. "SongEdit"'s music strings, see the sidebar.  It provides a
  73. guide to creating music with "SongEdit."
  74.      All other functions in "SongEdit" are controlled with
  75. function keys.  A list of those keys and their uses is
  76. always visible on your monitor.  Here is a run-down on
  77. "SongEdit"'s function keys:
  78.  
  79.      F1:  Pressing this key calls up two help screens which
  80. provide information on  music notation.  Press <Enter> to
  81. skip the second screen, or any other key for more help.
  82.  
  83.      F2:  This key allows you to play "SongEdit" tunes.  The
  84. first menu choice lets you play the tune currently visible
  85. in the editing area.  The second allows you to play a series
  86. of .TUN files, without any breaks.  The third choice returns
  87. to the editing screen.
  88.      Choose by typing the number of your selection.  If you
  89. choose the multiple play option, enter the names of the
  90. files without the .TUN extension.  You can play as many as
  91. six files, sequentially.  If you wish to play less than six
  92. tunes, just press <Enter> without naming a file.
  93.      Experiment with this feature, using the sample files
  94. provided on the disk.  Try playing PART1.TUN, PART2.TUN, and
  95. PART3.TUN in sequence.  Any tune can be repeated by entering
  96. its name on more than one line.
  97.      F3:  This key allows you to play the note at the
  98. current cursor location.  The note will play in octave 2,
  99. without sharps or flats.
  100.      If the cursor is over a character which is not a note,
  101. an error message will display and the program will return to
  102. the editing routine.
  103.  
  104.      F4:  This key plays the tune displayed in the editing
  105. area.  Use this function frequently to save time and catch
  106. errors while they are easy to correct.
  107.  
  108.    F5:  Pressing this key moves you to the file handling
  109. routine in "SongEdit".  A menu, will allow you to load a
  110. file, save a file, or return to the editor.
  111.      To load a file, type the name of a .TUN file without
  112. the extension.  The tune you have loaded will play, then the
  113. program returns to the editor, printing the tune in the
  114. editing area.
  115.      If you choose to save a file, enter the name of the
  116. file at the prompt line, without the .TUN extension.  After
  117. you press <Enter>, choose whether to save the file as a .TUN
  118. file, to be used with "SongEdit", or as a .BAS file, which
  119. can be run as a BASICA/GWBASIC program.  "SongEdit" gives
  120. the tune an arbitrary line number of 10.
  121.  
  122.      F6:  This key removes the current song from the editing
  123. area and erases it from memory.  You have an opportunity to
  124. abort the function.  If you have not saved the file, it will
  125. be lost permanently, so use this function with caution.
  126.  
  127.      F7:  If you press this key, you call the random tune
  128. generator.  "SongEdit" uses a random number generator and a
  129. note selection algorithm to compose music.
  130.      You can choose the tempo of the tune, along with the
  131. number of notes to be played.  The tempo is expressed in
  132. beats per minute, with a range from 32 to 255.  Select up to
  133. 50 notes.
  134.      After composing the tune, "SongEdit" will play it, then
  135. ask if you want to transfer the tune to the editor. The
  136. tunes produced by this feature are unpredictable, and no two
  137. tunes are ever alike.
  138.  
  139.      F8:  Pressing this function key loads a sample tune
  140. into the editor.  This tune is imbedded in the program code
  141. and cannot be changed.  Use it as a demonstration.
  142.  
  143.      F9:  This key provides a list of the .TUN files on your
  144. floppy disk or in the \SONGEDIT directory on your hard disk.
  145. Press any key to return to the editor.
  146.  
  147.      F10:  The F10 key allows you to exit the program,
  148. giving you a chance to change your mind.  Any tune not saved
  149. when you exit will be lost.
  150.  
  151.      
  152.  
  153.         Sidebar: Songedit Syntax
  154.  
  155.      "SongEdit" uses the same syntax as BASICA/GWBASIC's
  156. PLAY statement for its tune strings.  All characters entered
  157. into the string can be either upper or lower case.
  158.      For convenience, "SongEdit" allows strings up to 240
  159. characters long, and automatically rejects characters after
  160. that length is reached.
  161.      Here are the commands used in "SongEdit" strings,
  162. presented in the order you are most likely to use: Note: Do
  163. not include the parentheses () when typing commands.
  164.  
  165.      T(n)
  166.      This command sets the tempo for your tune.  Use a
  167. number from 32-255 for (n).  The tempo you select will
  168. remain in effect until it is changed.
  169.  
  170.      O(n)
  171.      The "O" command sets the octave.  Choose a value from
  172. 0-6 for (n).  As with the "T" command the octave setting
  173. remains in effect until changed.  Middle C is in octave 3.
  174.  
  175.      M(L,N,S)
  176.      The "M" command changes the way each note is played. An
  177. "ML" command plays each note full length.  To play each note
  178. for 7/8 of its value, use the command "MN."  For stacatto
  179. notes, each played for 3/4 of its value, the command is
  180. "MS."  These commands remain in effect until changed.
  181.  
  182.      A-G(n)
  183.      These are the actual notes used in "SongEdit" tune
  184. strings.  They represent the normal notes of the scale.
  185. Specify the length for each note with a value for (n)
  186. between 1 and 64.  Each number represents a type of note.
  187. For example, 1 represents a whole note, 4 a quarter note
  188. which gets one beat, and so on.  Triplet figures are formed
  189. with note lengths which are multiples of 3.
  190.  
  191.      L(n)
  192.      This command sets up a default length for all notes
  193. which follow.  Including the command "L8," for example,
  194. makes all the notes which follow equivalent to eighth notes
  195. unless another number is attached to an individual note.
  196.  
  197.      P(n)
  198.      Use this command to create rests or pauses in your
  199. music.  The values for (n) are the same as those used to
  200. specify note length.  "P8" produces an eighth rest.
  201.  
  202.      < or >
  203.      These commands are a shortcut for changing octaves. The
  204. command "<" moves the following notes down one octave, while
  205. ">" moves them up one octave.  As an example, here is a one-
  206. octave scale:  CDEFGAB>C.  All songedit octaves start with
  207. the note C.
  208.  
  209.      + or #
  210.      Makes the preceeding note sharp.  Place this character
  211. after the note character, but before the length parameter.
  212.  
  213.      - (minus sign)
  214.      Makes the preceeding note flat.
  215.  
  216.      .(period character)
  217.      Increases the length of the note or pause by a factor
  218. of 1.5.  Use this dot character in the same way you would in
  219. standard music notation.  The command "C4." produces a
  220. dotted quarter note, equivalent to a quarter note plus an
  221. eighth note.
  222.  
  223.      As a general rule, set the tempo (Tn), the mode (Mn)
  224. and the starting octave (On) at the beginning of each tune
  225. file.  Enter other commands as you choose to create your
  226. tune.
  227.  
  228.  
  229. SHAREWARE NOTICE
  230.  
  231. SONGEDIT is a shareware program.  What that means is that you are free 
  232. to try it out and experiment with it for as long as you like.
  233. If you enjoy the program, and use it frequently, the author 
  234. requests a registration fee of $10.  For that fee, you will 
  235. receive notices of any upgrades to SONGEDIT, as well as the peace
  236. of mind gained by knowing that you have helped pay for the work
  237. the author has put into the program.
  238.  
  239. You are free to distribute SONGEDIT through bulletin boards and other
  240. methods.  SONGEDIT may not be distributed for profit, nor may any
  241. fee greater than $10 be charged for distribution on disk.
  242.  
  243. Please distribute the entire package, including this documentation
  244. and all sample tunes.  The best way to do that is to distribute
  245. the SONGEDIT.ARC file.  That way, all files will be included.
  246.  
  247. Please add your own musical creations to the distribution file.
  248. They'll add enjoyment for other users. I'd also be overjoyed to
  249. see copies of your music.  You can send them to the address below.
  250.  
  251. Send all comments, sample music, and registration fees to:
  252.  
  253. George Campbell
  254. 1472 Sixth St.
  255. Los Osos, CA  93402
  256. GEnie: G.CAMPBELL
  257. CIS: 71571,222